home *** CD-ROM | disk | FTP | other *** search
/ Software of the Month Club 1997 March / Software of the Month Club 1997 March.iso / pc / dos / lg / moon / moon.txt < prev    next >
Encoding:
Text File  |  1996-10-31  |  10.6 KB  |  279 lines
  1.  
  2.                    The Moon Viewer 3.0
  3.                Windows Moon Background 1.0
  4.  
  5.                         Shareware
  6.         
  7.             The Best Moon Shareware Package
  8.  
  9.          Copright (C) 1996 By Lorenzo Pasqualis
  10.                   All rights reserved
  11.  
  12.  
  13. Moon Viewer Short Guide.
  14.  
  15.   This is just a short guide. The Moon Viewer is very  easy
  16.   to use and I'm not going to write a complete manual.  I'm
  17.   sure that you will find this short guide detailed  enough
  18.   to use Moon Viewer.
  19.  
  20.   Please, apologize for my english. You will probably  find
  21.   many english errors  in  this  file.  My  first  language
  22.   is Italian. I'm sure that the quality  of  this  software
  23.   is more important and  will  satisfy  you  more  than  my
  24.   english!
  25.  
  26.  
  27. Run Moon Viewer:
  28.  
  29.   To run the program just run MOON.EXE from the Command Prompt
  30.   or from Windows. There aren't command line parameter.
  31.  
  32. Notation:
  33.  
  34.   UTC = Universal Time (Greenwich Mean Time).
  35.   LT  = Local Time (Your time in your zone).
  36.   
  37.  
  38. Start screen:
  39.  
  40.   The start screen is different if you are a registered user or not.
  41.  
  42.   - If you are a shareware user (not registered) you have to read the
  43.     LICENSE agreement that will be showed. You can scroll the window
  44.     with PagUp/PagDown keys (or arrows). If you agree with the
  45.     license just press Y (that mean.. YES, I AGREE!), and you will
  46.     be jumped in the Main Screen.
  47.  
  48.     If you don't agree just press ESC to exit to DOS. You must agree
  49.     to use this trial version of Moon Viewer.
  50.  
  51.   - If you are a registerd user, Moon Viewer will show you a window
  52.     with written that you are registered, and with your name,
  53.     address and all datas. If you press a key or if you wait 3 sec.
  54.     the screen disappear and you go directly to the Main Screen. No
  55.     boring license agreement to read!! :)
  56.  
  57. Main screen:
  58.   
  59.   WOW! On the top, in the center of your monitor you can see the
  60.   actual Moon!!! If you see just a dark circle it mean that you are
  61.   in the New Moon phase. If you see the full Moon without shadow on
  62.   it... of curse, you are in the full Moon phase!
  63.  
  64.   There are 4 windows showing many information. The first one, on
  65.   the left, is the "Information window" where you can read everything
  66.   about the Moon in the picture. Then there is a Status window where
  67.   you can read the status of the program and the actual REAL date and
  68.   time.
  69.   The third window is the Menu', with all the commands available.
  70.   The little window on the bottom of the screen is the "Last file
  71.   written" window, where you can read the name of the last file
  72.   exported. Just to remember if you have export something.
  73.  
  74. Information Window:
  75.  
  76.   Julian Date:
  77.         Is the Universal Time written in the Julian calendar, that is
  78.         the number of days occuring from 1-1-4713 B.C. (year 4712 in
  79.         the astronomical use). Is a standard date for astronomical
  80.         calcolous. If you are interested just take a good encyclopedia
  81.         and look for "Julian Date" or "Calendar" or "Date".
  82.                        
  83.   Local Time:
  84.         The local time of the Moon in the picture.
  85.  
  86.   Universal Time (UTC or GMT):
  87.         The local time converted in Greenwich Mean Time. Please read
  88.         README.TXT "installation" and "timezone.txt" for more information
  89.         how to set up your environment. You should set the standard
  90.         environment varabile TZ to be sure that the computation of the
  91.         Moon is right.
  92.         
  93.   Age of the Moon:
  94.         The age in Days, houres and minutes from the last New Moon.
  95.  
  96.   Moon phase:
  97.         The percent of the Moon with light! (0%=NEW, 100%=FULL).
  98.  
  99.   Moon's distance:
  100.         The distance of the Moon from the Earth expressed in Km.
  101.  
  102.   Sun's distance:
  103.         The distance of the Sun from the Earth expressed in Km.
  104.         
  105.   Last New Moon,
  106.   First Quarter,
  107.   New Moon,
  108.   Last Quarter,
  109.   Next New Moon:
  110.         The date and time of phases. 
  111.  
  112.   Easter:
  113.         The Easter date of the current year. This can be computer
  114.         "only" after 1583 because before it wasn't clear how to
  115.         define the Easter date.
  116.  
  117.   Last Blue Moon,
  118.   Next Blue Moon:
  119.         Date and time of the last and next Blue Moon. The Blue Moon
  120.         is the second full Moon in the same month. Very rare!! Read
  121.         bluemoon.txt for more information.
  122.  
  123.  
  124. Status Window:
  125.  
  126.   In the first two lines you can see the actual time and date.
  127.   This is not always equal to the Local Time in the information
  128.   window. The information window show information about the Moon
  129.   that you see in the picture, Status window show the state of the
  130.   program and computer. You can change the time/date of the Moon
  131.   that you want to display, but you cannot change the time/date of
  132.   your computer (..of curse you can from the DOS prompt...).
  133.   You can also read, to the right of the time, about your current
  134.   GMT difference setting. Check if is correct referring to the
  135.   timediff.txt file.
  136.  
  137.   Animation:
  138.         Can be ON or OFF. You can turn ON/OFF the animation with
  139.         the [A] key. If the animation is ON the picture will be
  140.         refreshed every X seconds. You can change the X value with
  141.         [+]/[-] keys. In the Actual Moon Mode this is not very useful,
  142.         but in the One Day Step is very interesting to see how the
  143.         Moon change every day. Just read below and everything will
  144.         be clearer.
  145.  
  146.   Delay:
  147.         This is the number of seconds of delay between two subsequent
  148.         refreshes of the Moon if you are in Animation ON mode.
  149.         You can chage it with [+]/[-] keys. The delay can be from 0 sec
  150.         (MAX speed) to 3600 sec. (MIN speed).
  151.  
  152.   Mode:
  153.         ACTUAL MOON: You are in this mode when you start Moon Viewer
  154.                      or when you press the [M] key. In this mode you
  155.                      are always sure that the Moon on your screen is the
  156.                      actual Moon that you can see in your sky!!!
  157.  
  158.         CUSTOM: You are in Custom Mode if you have changed the
  159.                 Date/Time of the showed Moon using [D] or [T] keys.
  160.  
  161.         ONE DAY STEP: You are in this mode if you pressed the [S] key.
  162.                       In this mode every time that the Moon is refreshed
  163.                       the date is increased of one day. You can
  164.                       refresh the Moon manually with the [F] key or
  165.                       automatically with the Animation ON mode (key [A]).
  166.  
  167.   Picture:
  168.         You can switch the Moon view with the [SPACE] bar:
  169.  
  170.         PHOTO: If you see the photographic picture of the Moon.
  171.         DRAFT: If you see the schematic picture of the Moon.
  172.  
  173.  
  174.   In the little box in the Status window there is a flag that show you
  175.   if Moon Viewer is working. When there is the word "WORK" inside this
  176.   box mean that Moon Viewer is working.
  177.   Note that Moon Viewer don't accept commands when you see the word
  178.   "WORK" in the box.
  179.  
  180.  
  181. Menu' Window:
  182.  
  183.   The Menu' window show all the possible commands.
  184.  
  185.   Animation related commands:
  186.  
  187.   [A] = Switch Animation ON and OFF. The default is ON
  188.   [+] = Increment the delay of the animation (animation slower).
  189.   [-] = Decrement the delay of the animation (animation faster).
  190.   [F] = Force refresh. To manually force the computation of the Moon.
  191.  
  192.   Mode related commands:
  193.  
  194.   [M] = Switch to actual Moon mode. To show the actual moon.
  195.   [S] = Switch to One Day Step. To show how the Moon change every day.
  196.   [D] = Insert a new Date. This key allow you to specify a date for the
  197.         computation of the Moon datas. A little help window will help
  198.         you to insert a right date.
  199.  
  200.         IMPORTANT:
  201.  
  202.            * Note that the format is DAY-MONTH-YEAR,
  203.              not MONTH-DAY-YEAR as normally used in US.
  204.  
  205.            * Also note that you must specify the FULL year. For example
  206.              5-1-1996 (5 Jenuary 1996) IS DIFFERENT from 5-1-96 (that
  207.              is 5 Jenuary of year 96 ... about 1900 years ago !!!).
  208.  
  209.            * In the registered you can specify a date from 1-1-9999 B.C.
  210.              to 31-12-9999
  211.              In the not registered version you can specify dates only
  212.              from 1-1-1900
  213.  
  214.            * If you want to specify a date B.C. you have to add
  215.              "bc" after the date. For example 1 jenuary 234 B.C.
  216.              must be written: 1-1-234 bc
  217.  
  218.            * The calendar before 1583 is reported to the actual calendar.
  219.              I don't want to write a story of the calendar, so I do not
  220.              explain what is happened to the calendar in 1583, you can
  221.              find many information about that in any encyclopedia.
  222.   
  223.   [T] = Insert a new time. You must specify the time in 24h full format!
  224.         So to specify 3:35 PM you must type 15:35:00
  225.         Note that the format is HH:MM:SS. To specify 1:10 AM you must
  226.         type: 01:10:00
  227.         Always two digits for houres, two digits for minutes and two
  228.         digits for seconds. You cannot type just 1:10:00
  229.  
  230.   [L] = Switch to Local Time Mode. All times are displayed as local
  231.         time (your time). This is the default.
  232.  
  233.   [U] = Switch to Universal Time Mode. All times are displayed as
  234.         Universal Time. This don't affect the time in the Status window,
  235.         that is always YOUR time.
  236.  
  237.   [C] = To enter in the calendar mode.
  238.  
  239.   Various commands:
  240.  
  241.   [SPACE] = Switch between Photo/Draft picture.
  242.  
  243.   [B] = Write the current Moon picture to a BMP file. If you save a BMP
  244.         the name of the file will be written in the Last Written File
  245.         window.
  246.  
  247.   [ESC] = Return to DOS.
  248.  
  249.  
  250. The Calendar Mode:
  251.           
  252.   If you enter in the calendar mode a new big window is opened on the
  253.   top of the screen. This window show you the calendar of phases of
  254.   the year showed in the information window. If you want to change
  255.   the date of the calendar you have to use the [D] command of the
  256.   main menu'. For example if you are interested in the calendar of the
  257.   Moon of year 0 you can specify the date 1-1-0 and press [C] to enter
  258.   in calendar mode.
  259.  
  260.   When you enter in calendar mode a new Export menu' window is opened
  261.   and you can choose to export the calendar in BMP, HTML or TXT format.
  262.   Note that the file name of these files is fixed and files are written
  263.   in the Moon Viewer directory. If you export the calendar the name of
  264.   the files will be written in the Last File Written window.
  265.  
  266.   Files names are generated in this format:
  267.  
  268.         MCXXXXAA.EXT
  269.  
  270.   Where: MC is fixed and mean "Moon Calendar".
  271.          XXXX is the calendar year.
  272.          AA is "bc" if the date is B.C. or nothing if is A.C.
  273.          EXT is the extension (HTM, BMP or TXT).
  274.  
  275.          For example HTML calendar of the year 747 B.C. will be
  276.          named MC747BC.HTM
  277.  
  278. *END*
  279.